home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Performance Co-Pilot 1.3
/
SGI Performance Co-Pilot 1.3.iso
/
dist
/
pcp.idb
/
usr
/
share
/
catman
/
u_man
/
cat3
/
PMAPI
/
pmdelprofile.z
/
pmdelprofile
Wrap
Text File
|
1997-04-03
|
5KB
|
67 lines
PPPPMMMMDDDDEEEELLLLPPPPRRRROOOOFFFFIIIILLLLEEEE((((3333)))) PPPPMMMMDDDDEEEELLLLPPPPRRRROOOOFFFFIIIILLLLEEEE((((3333))))
NNNNAAAAMMMMEEEE
ppppmmmmDDDDeeeellllPPPPrrrrooooffffiiiilllleeee - delete instance(s) from the current PMAPI instance profile
CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
iiiinnnntttt ppppmmmmDDDDeeeellllPPPPrrrrooooffffiiiilllleeee((((ppppmmmmIIIInnnnDDDDoooommmm iiiinnnnddddoooommmm,,,, iiiinnnntttt nnnnuuuummmmiiiinnnnsssstttt,,,, iiiinnnntttt iiiinnnnssssttttlllliiiisssstttt[[[[]]]]))))
cccccccc ............ ----llllppppccccpppp
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The set of instances for performance metrics returned from a ppppmmmmFFFFeeeettttcccchhhh(3)
call may be filtered or restricted using an instance profile. There is
one instance profile for each context the application creates at the
Performance Metrics Application Programming Interface (PMAPI), and each
instance profile may include instances from one or more instance domains
(see ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3)).
ppppmmmmDDDDeeeellllPPPPrrrrooooffffiiiilllleeee may be used to delete instance specifications from the
instance profile of the current PMAPI context.
In the simplest variant, the list of instances identified by the _i_n_s_t_l_i_s_t
argument for the _i_n_d_o_m instance domain are removed from the instance
profile. The list of instance identifiers contains _n_u_m_i_n_s_t values.
The _i_n_d_o_m value would normally be extracted from a call to
ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular performance metric, and the instances in
_i_n_s_t_l_i_s_t would typically be determined by calls to ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3) or
ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm(3).
If _i_n_d_o_m equals PPPPMMMM____IIIINNNNDDDDOOOOMMMM____NNNNUUUULLLLLLLL or _n_u_m_i_n_s_t is zero, then all instance
domains are selected for deletion. If _i_n_s_t_l_i_s_t is (_i_n_t *)_0, then all
instances in the selected domain(s) are removed from the profile.
To disable all available instances in all domains, use
_p_m_D_e_l_P_r_o_f_i_l_e(_P_M__I_N_D_O_M__N_U_L_L, _0, (_i_n_t *)_0). This is the only situation in
which _i_n_d_o_m may be PPPPMMMM____IIIINNNNDDDDOOOOMMMM____NNNNUUUULLLLLLLL.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
PPPPMMMMAAAAPPPPIIII(3), ppppmmmmAAAAddddddddPPPPrrrrooooffffiiiilllleeee(3), ppppmmmmFFFFeeeettttcccchhhh(3), ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3), ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3),
ppppmmmmLLLLooooooookkkkuuuuppppIIIInnnnDDDDoooommmm(3), ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt(3), ppppmmmmUUUUsssseeeeCCCCoooonnnntttteeeexxxxtttt(3) and ppppmmmmWWWWhhhhiiiicccchhhhCCCCoooonnnntttteeeexxxxtttt(3).
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
PPPPMMMM____EEEERRRRRRRR____PPPPRRRROOOOFFFFIIIILLLLEEEESSSSPPPPEEEECCCC
_i_n_d_o_m was PPPPMMMM____IIIINNNNDDDDOOOOMMMM____NNNNUUUULLLLLLLL and _i_n_s_t_l_i_s_t was not empty
CCCCAAAAVVVVEEEEAAAATTTT
It is possible to delete non-existent instance domains and non-existent
instances from an instance profile. None of the routines that use the
instance profile will ever issue an error if you do this. The cost of
checking, when checking is possible, outweighs any benefits.
PPPPaaaaggggeeee 1111